home *** CD-ROM | disk | FTP | other *** search
/ Windows Game Programming for Dummies (2nd Edition) / WinGamProgFD.iso / pc / DirectX SDK / DXSDK / samples / Multimedia / VBSamples / DirectMusic / SimpleAudioPath / readme.txt < prev    next >
Encoding:
Text File  |  2001-10-10  |  2.3 KB  |  59 lines
  1. //-----------------------------------------------------------------------------
  2. // 
  3. // Sample Name: SimpleAudioPath Sample
  4. // 
  5. // Copyright (C) 1999-2001 Microsoft Corporation. All rights reserved.
  6. //
  7. // GM/GS« Sound Set Copyright ⌐1996, Roland Corporation U.S.
  8. // 
  9. //-----------------------------------------------------------------------------
  10.  
  11.  
  12.  
  13. Description
  14. ===========
  15.   The AudioPath sample demonstrates how different sounds can be played 
  16.   on an audiopath, and how the parameters of all sounds are affected 
  17.   by changes made on the audiopath.
  18.  
  19. Path
  20. ====
  21.   Source: DXSDK\Samples\Multimedia\VBSamples\DirectMusic\SimpleAudioPath
  22.  
  23.   Executable: DXSDK\Samples\Multimedia\VBSamples\DirectMusic\Bin
  24.  
  25. User's Guide
  26. ============
  27.   Click Lullaby, Snore, and Mumble to play different sounds. Adjust the 
  28.   3-D position of the sounds by using the sliders. Click Rude Awakening 
  29.   to play a different sound and stop all other sounds.
  30.  
  31. Programming Notes
  32. =================
  33.   The AudioPath differs by showing some of the various uses of an
  34.   audiopath. Here's how:
  35.   
  36.   * Upon init. 
  37.         1. Calls DirectMusicPerformance8::CreateStandardAudioPath passing
  38.            in DMUS_APATH_DYNAMIC_3D to create a 3D audiopath.
  39.         2. Loads all of the files needed for this sample.  
  40.   
  41.   * Upon 3D positoin slider change.  See SetPosition
  42.         1. Calls DirectMusicAudioPath.GetObjectInPath on the 3D audiopath to
  43.            get the DirectSound3DBuffer from it.
  44.         2. Calls DirectSound3DBuffer.SetPosition to set a new 3D position on
  45.            the buffer of the audiopath.
  46.         
  47.   * Upon button click.  See cmdSeg_Click.
  48.         - If its the first button, "Lullaby", this plays the primary segment
  49.           on the 3D audiopath by calling PlaySegmentEx passing in 
  50.           DMUS_SEGF_DEFAULT and the 3D audiopath.
  51.         - If its the second or third button, this plays a secondary segment
  52.           on the 3D audiopath by calling PlaySegmentEx passing in 
  53.           DMUS_SEGF_DEFAULT or DMUS_SEGF_SECONDARY and the 3D audiopath.
  54.         - If its the forth button, "Rude Awakening", this plays a primary segment
  55.           on the 3D audiopath by calling PlaySegmentEx passing in 
  56.           the 3D audiopath, and setting the pFrom to the 3D audiopath. 
  57.           This causes all currently playing segments to stop when this one starts.
  58.  
  59.